Skip to content

feat: implement cap deep links and raycast extension #1564

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
d3vv3r wants to merge 6 commits into
base: main
Choose a base branch
from
Open

feat: implement cap deep links and raycast extension #1564

d3vv3r wants to merge 6 commits into from

Conversation

@d3vv3r
Copy link

@d3vv3r d3vv3r commented Jan 30, 2026 •
edited
Loading

Closes #1540

Greptile Overview

Greptile Summary

This PR implements Cap deep link support and a Raycast extension for controlling recordings via keyboard shortcuts. The implementation adds a new cap:// URL scheme that enables external applications to control Cap's recording functionality.

Key changes:

  • Added four new deep link actions: StartDefaultRecording, PauseRecording, ResumeRecording, and StopRecording to deeplink_actions.rs
  • Registered the cap:// URL scheme in Tauri configuration alongside the existing cap-desktop:// scheme
  • Created a Raycast extension with four commands that trigger these deep links
  • Deep link parsing now checks for cap:// scheme first before falling back to the existing action-based parsing
  • Pause and resume actions properly emit RecordingEvent::Paused and RecordingEvent::Resumed events to update the UI

Implementation quality:
The Rust implementation follows repository conventions with proper error handling and async patterns. The pause/resume handlers correctly access the current recording state and emit the appropriate events. The StartDefaultRecording action provides a sensible default (first display, Studio mode, system audio enabled) for quick recording starts.

Confidence Score: 5/5

  • This PR is safe to merge with no blocking issues
  • The implementation is clean and follows existing patterns. The deep link handlers properly reuse existing recording methods, emit correct events, and handle errors appropriately. All TypeScript code is simple and follows Raycast conventions.
  • No files require special attention

Important Files Changed

Filename Overview
apps/desktop/src-tauri/src/deeplink_actions.rs Added deep link handlers for pause/resume/start-default recording actions with proper event emission
apps/desktop/src-tauri/tauri.conf.json Registered new cap:// URL scheme alongside existing cap-desktop:// scheme for deep links
extensions/raycast/package.json Created Raycast extension manifest with four commands for recording control
extensions/raycast/src/start-recording.ts Opens cap://record deep link to trigger default recording start
extensions/raycast/src/stop-recording.ts Opens cap://stop deep link to stop active recording
extensions/raycast/src/pause-recording.ts Opens cap://pause deep link to pause active recording
extensions/raycast/src/resume-recording.ts Opens cap://resume deep link to resume paused recording

Sequence Diagram

sequenceDiagram
    participant Raycast as Raycast Extension
    participant OS as Operating System
    participant Tauri as Tauri Deep Link Handler
    participant Parser as DeepLinkAction Parser
    participant App as Cap Desktop App
    participant Recording as Recording Module
    participant Frontend as Desktop Frontend

    Raycast->>OS: open("cap://record")
    OS->>Tauri: Route cap:// URL
    Tauri->>Parser: Parse URL to DeepLinkAction
    Parser->>Parser: Match domain (record/stop/pause/resume)
    Parser-->>Tauri: Return DeepLinkAction variant
    Tauri->>App: execute(StartDefaultRecording)
    App->>Recording: list_displays()
    Recording-->>App: Display list
    App->>App: Select first display
    App->>Recording: start_recording(inputs)
    Recording-->>App: Recording started
    
    Note over Raycast,Frontend: Pause Flow
    Raycast->>OS: open("cap://pause")
    OS->>Tauri: Route cap:// URL
    Tauri->>Parser: Parse URL
    Parser-->>Tauri: DeepLinkAction::PauseRecording
    Tauri->>App: execute(PauseRecording)
    App->>Recording: recording.pause()
    Recording-->>App: Ok()
    App->>Frontend: RecordingEvent::Paused.emit()
    
    Note over Raycast,Frontend: Resume Flow
    Raycast->>OS: open("cap://resume")
    OS->>Tauri: Route cap:// URL
    Tauri->>Parser: Parse URL
    Parser-->>Tauri: DeepLinkAction::ResumeRecording
    Tauri->>App: execute(ResumeRecording)
    App->>Recording: recording.resume()
    Recording-->>App: Ok()
    App->>Frontend: RecordingEvent::Resumed.emit()
    
    Note over Raycast,Frontend: Stop Flow
    Raycast->>OS: open("cap://stop")
    OS->>Tauri: Route cap:// URL
    Tauri->>Parser: Parse URL
    Parser-->>Tauri: DeepLinkAction::StopRecording
    Tauri->>App: execute(StopRecording)
    App->>Recording: stop_recording()
    Recording-->>App: Recording stopped
Loading

(2/5) Greptile learns from your feedback when you react with thumbs up/down!

Bounty Claim

/claim #1540

Walkthrough

I have implemented the deep link support and Raycast extension as requested.

tembo[bot]
tembo bot reviewed Jan 30, 2026
View reviewed changes
@algora-pbc algora-pbc bot mentioned this pull request Jan 30, 2026
Open
tembo[bot]
tembo bot reviewed Feb 3, 2026
View reviewed changes
d3vv3r added 2 commits February 3, 2026 22:37
@d3vv3r
fix: address maintainer feedback (COM init tracking, host_str parsing…
d2979fb 
…, script portability)
@d3vv3r
Fix recording save instability and Windows GPU/YUV converter crashes
22e7bb8 
This commit includes:\n- Balanced Media Foundation/COM initialization via ThreadInitGuard\n- Fixed GPU adapter mismatch defaulting to WARP on Windows\n- Optimized YUV converter to use shared pipelines\n- Fixed various type mismatches and syntax errors in recording pipelines
@d3vv3r
Copy link
Author

d3vv3r commented Feb 4, 2026 •
edited
Loading

I've implemented several stability fixes for the Windows recording pipeline:

  • Balanced Media Foundation/COM initialization via ThreadInitGuard and proper thread_uninit calls to prevent crashes in the recording save and start/stop cycles.
  • Fixed a GPU adapter mismatch that was causing Cap to default to the WARP software rasterizer on Windows even when hardware acceleration was available.
  • Optimized the YUV converter to use shared pipelines, reducing GPU memory overhead.
  • Fixed various type mismatches and syntax errors in the recording pipelines discovered during the stability audit.

Verification was successful on Windows, showing consistent recording starts and saves without the previous instability. A proof of verification video is available.

display.mp4

Closes #1540

tembo[bot]
tembo bot reviewed Feb 4, 2026
View reviewed changes
tembo[bot]
tembo bot reviewed Feb 7, 2026
View reviewed changes
metadata.json
Copy link

@tembo tembo bot Feb 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks like a local cargo metadata dump and it leaks absolute Windows paths (e.g. C:\\DEV\\...) into the repo. I’d drop this file from the PR (and consider ignoring it) since it’s machine-local state and can create noisy diffs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@tembo tembo[bot] tembo[bot] left review comments

Assignees

No one assigned

Labels

🙋 Bounty claim

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Bounty: Deeplinks support + Raycast Extension

1 participant

@d3vv3r